buildable: Rename set_name() to set_buildable_id()

GtkBuildable's get_name()/set_name() methods may shadow
GtkWidget's methods. Avoid that by renaming the API to
get_buildable_id()/set_buildable_id(), which also reflects
the name of the XML attribute the API refers to.

https://gitlab.gnome.org/GNOME/gtk/-/issues/3191

diff --git a/demos/widget-factory/widget-factory.c b/demos/widget-factory/widget-factory.c
index 48329d401896e6c4d4fdb73199d23d6e2399aae1..021b69e6401da81a5b4aac13b0a329a2632ef427 100644 (file)
--- a/demos/widget-factory/widget-factory.c
+++ b/demos/widget-factory/widget-factory.c
@@ -1398,7 +1398,7 @@ handle_insert (GtkWidget *button, GtkWidget *textview)
   const char *id;
   const char *text;
 
-  id = gtk_buildable_get_name (GTK_BUILDABLE (button));
+  id = gtk_buildable_get_buildable_id (GTK_BUILDABLE (button));
 
   if (strcmp (id, "toolbutton1") == 0)
     text = "⌘";
@@ -1424,7 +1424,7 @@ handle_cutcopypaste (GtkWidget *button, GtkWidget *textview)
 
   clipboard = gtk_widget_get_clipboard (textview);
   buffer = gtk_text_view_get_buffer (GTK_TEXT_VIEW (textview));
-  id = gtk_buildable_get_name (GTK_BUILDABLE (button));
+  id = gtk_buildable_get_buildable_id (GTK_BUILDABLE (button));
 
   if (strcmp (id, "cutbutton") == 0)
     gtk_text_buffer_cut_clipboard (buffer, clipboard, TRUE);
@@ -1442,7 +1442,7 @@ clipboard_formats_notify (GdkClipboard *clipboard, GdkEvent *event, GtkWidget *b
   const char *id;
   gboolean has_text;
 
-  id = gtk_buildable_get_name (GTK_BUILDABLE (button));
+  id = gtk_buildable_get_buildable_id (GTK_BUILDABLE (button));
   has_text = gdk_content_formats_contain_gtype (gdk_clipboard_get_formats (clipboard), GTK_TYPE_TEXT_BUFFER);
 
   if (strcmp (id, "pastebutton") == 0)
@@ -1455,7 +1455,7 @@ textbuffer_notify_selection (GObject *object, GParamSpec *pspec, GtkWidget *butt
   const char *id;
   gboolean has_selection;
 
-  id = gtk_buildable_get_name (GTK_BUILDABLE (button));
+  id = gtk_buildable_get_buildable_id (GTK_BUILDABLE (button));
   has_selection = gtk_text_buffer_get_has_selection (GTK_TEXT_BUFFER (object));
 
   if (strcmp (id, "cutbutton") == 0 ||

diff --git a/docs/reference/gtk/gtk4-sections.txt b/docs/reference/gtk/gtk4-sections.txt
index 72968d98a49d32d67bce1174519a8e842ee42b0f..d93c23e29791109902953e1618610abebe031803 100644 (file)
--- a/docs/reference/gtk/gtk4-sections.txt
+++ b/docs/reference/gtk/gtk4-sections.txt
@@ -617,8 +617,8 @@ gtk_grid_view_get_type
 GtkBuildable
 GtkBuildableIface
 GtkBuildableParser
-gtk_buildable_set_name
-gtk_buildable_get_name
+gtk_buildable_set_buildable_id
+gtk_buildable_get_buildable_id
 gtk_buildable_add_child
 gtk_buildable_set_buildable_property
 gtk_buildable_construct_child

diff --git a/gtk/gtkbuildable.c b/gtk/gtkbuildable.c
index f5b26325e2ad77b30c00a9c3bb3512eafbaae466..8e73e20b4a18b13bf516941976ac097f3586a9ff 100644 (file)
--- a/gtk/gtkbuildable.c
+++ b/gtk/gtkbuildable.c
@@ -49,46 +49,46 @@ gtk_buildable_default_init (GtkBuildableInterface *iface)
 }
 
 /**
- * gtk_buildable_set_name:
+ * gtk_buildable_set_buildable_id:
  * @buildable: a #GtkBuildable
- * @name: name to set
+ * @id: name to set
  *
- * Sets the name of the @buildable object.
+ * Sets the ID of the @buildable object.
  **/
 void
-gtk_buildable_set_name (GtkBuildable *buildable,
-                        const char   *name)
+gtk_buildable_set_buildable_id (GtkBuildable *buildable,
+                      const char   *id)
 {
   GtkBuildableIface *iface;
 
   g_return_if_fail (GTK_IS_BUILDABLE (buildable));
-  g_return_if_fail (name != NULL);
+  g_return_if_fail (id != NULL);
 
   iface = GTK_BUILDABLE_GET_IFACE (buildable);
 
-  if (iface->set_name)
-    (* iface->set_name) (buildable, name);
+  if (iface->set_id)
+    (* iface->set_id) (buildable, id);
   else
     g_object_set_data_full (G_OBJECT (buildable),
-                           "gtk-builder-name",
-                           g_strdup (name),
+                           "gtk-builder-id",
+                           g_strdup (id),
                            g_free);
 }
 
 /**
- * gtk_buildable_get_name:
+ * gtk_buildable_get_buildable_id:
  * @buildable: a #GtkBuildable
  *
- * Gets the name of the @buildable object. 
+ * Gets the ID of the @buildable object.
  * 
  * #GtkBuilder sets the name based on the
  * [GtkBuilder UI definition][BUILDER-UI] 
  * used to construct the @buildable.
  *
- * Returns: the name set with gtk_buildable_set_name()
+ * Returns: the ID set with gtk_buildable_set_buildable_id()
  **/
 const char *
-gtk_buildable_get_name (GtkBuildable *buildable)
+gtk_buildable_get_buildable_id (GtkBuildable *buildable)
 {
   GtkBuildableIface *iface;
 
@@ -96,11 +96,11 @@ gtk_buildable_get_name (GtkBuildable *buildable)
 
   iface = GTK_BUILDABLE_GET_IFACE (buildable);
 
-  if (iface->get_name)
-    return (* iface->get_name) (buildable);
+  if (iface->get_id)
+    return (* iface->get_id) (buildable);
   else
     return (const char *)g_object_get_data (G_OBJECT (buildable),
-                                           "gtk-builder-name");
+                                           "gtk-builder-id");
 }
 
 /**

diff --git a/gtk/gtkbuildable.h b/gtk/gtkbuildable.h
index 7450103f575ae4fe0c39617ac3ea32a1b6374c60..9cb69dcaa3e96299c72694b6707413b37e9d979e 100644 (file)
--- a/gtk/gtkbuildable.h
+++ b/gtk/gtkbuildable.h
@@ -76,12 +76,12 @@ struct _GtkBuildableParser
 /**
  * GtkBuildableIface:
  * @g_iface: the parent class
- * @set_name: Stores the name attribute given in the GtkBuilder UI definition.
+ * @set_id: Stores the id attribute given in the GtkBuilder UI definition.
  *  #GtkWidget stores the name as object data. Implement this method if your
- *  object has some notion of “name” and it makes sense to map the XML name
+ *  object has some notion of “ID” and it makes sense to map the XML id
  *  attribute to it.
- * @get_name: The getter corresponding to @set_name. Implement this
- *  if you implement @set_name.
+ * @get_id: The getter corresponding to @set_id. Implement this
+ *  if you implement @set_id.
  * @add_child: Adds a child. The @type parameter can be used to
  *  differentiate the kind of child. #GtkWidget implements this
  *  to add event controllers to the widget, #GtkNotebook uses
@@ -126,9 +126,9 @@ struct _GtkBuildableIface
   GTypeInterface g_iface;
 
   /* virtual table */
-  void          (* set_name)               (GtkBuildable       *buildable,
-                                            const char         *name);
-  const char * (* get_name)               (GtkBuildable       *buildable);
+  void          (* set_id)                 (GtkBuildable       *buildable,
+                                            const char         *id);
+  const char * (* get_id)                  (GtkBuildable       *buildable);
   void          (* add_child)              (GtkBuildable       *buildable,
                                             GtkBuilder         *builder,
                                             GObject            *child,
@@ -169,10 +169,10 @@ GDK_AVAILABLE_IN_ALL
 GType     gtk_buildable_get_type               (void) G_GNUC_CONST;
 
 GDK_AVAILABLE_IN_ALL
-void      gtk_buildable_set_name               (GtkBuildable        *buildable,
-                                               const char          *name);
+void      gtk_buildable_set_buildable_id       (GtkBuildable        *buildable,
+                                               const char          *id);
 GDK_AVAILABLE_IN_ALL
-const char * gtk_buildable_get_name           (GtkBuildable        *buildable);
+const char * gtk_buildable_get_buildable_id    (GtkBuildable        *buildable);
 GDK_AVAILABLE_IN_ALL
 void      gtk_buildable_add_child              (GtkBuildable        *buildable,
                                                GtkBuilder          *builder,

diff --git a/gtk/gtkbuilder.c b/gtk/gtkbuilder.c
index 02541a4b84b6d3009c2f0c9be3e7aac63d52cc39..1e079c2ccc7d2d4a7643987b69076938d27a60e2 100644 (file)
--- a/gtk/gtkbuilder.c
+++ b/gtk/gtkbuilder.c
@@ -623,12 +623,12 @@ gtk_builder_get_parameters (GtkBuilder         *builder,
 }
 
 static const char *
-object_get_name (GObject *object)
+object_get_id (GObject *object)
 {
   if (GTK_IS_BUILDABLE (object))
-    return gtk_buildable_get_name (GTK_BUILDABLE (object));
+    return gtk_buildable_get_buildable_id (GTK_BUILDABLE (object));
   else
-    return g_object_get_data (object, "gtk-builder-name");
+    return g_object_get_data (object, "gtk-builder-id");
 }
 
 static GObject *
@@ -650,7 +650,7 @@ gtk_builder_get_internal_child (GtkBuilder   *builder,
 
       GTK_NOTE (BUILDER,
                 g_message ("Trying to get internal child %s from %s",
-                           childname, object_get_name (info->object)));
+                           childname, object_get_id (info->object)));
 
       if (GTK_IS_BUILDABLE (info->object))
           obj = gtk_buildable_get_internal_child (GTK_BUILDABLE (info->object),
@@ -669,13 +669,13 @@ gtk_builder_get_internal_child (GtkBuilder   *builder,
 }
 
 static inline void
-object_set_name (GObject     *object,
-                 const char *name)
+object_set_id (GObject     *object,
+                 const char *id)
 {
   if (GTK_IS_BUILDABLE (object))
-    gtk_buildable_set_name (GTK_BUILDABLE (object), name);
+    gtk_buildable_set_buildable_id (GTK_BUILDABLE (object), id);
   else
-    g_object_set_data_full (object, "gtk-builder-name", g_strdup (name), g_free);
+    g_object_set_data_full (object, "gtk-builder-id", g_strdup (id), g_free);
 }
 
 void
@@ -685,7 +685,7 @@ _gtk_builder_add_object (GtkBuilder  *builder,
 {
   GtkBuilderPrivate *priv = gtk_builder_get_instance_private (builder);
 
-  object_set_name (object, id);
+  object_set_id (object, id);
   g_hash_table_insert (priv->objects, g_strdup (id), g_object_ref (object));
 }
 
@@ -984,7 +984,7 @@ _gtk_builder_add (GtkBuilder *builder,
 
   if (!child_info->parent)
     {
-      g_warning ("%s: Not adding, No parent", object_get_name (object));
+      g_warning ("%s: Not adding, No parent", object_get_id (object));
       return;
     }
 
@@ -993,7 +993,7 @@ _gtk_builder_add (GtkBuilder *builder,
   parent = ((ObjectInfo*)child_info->parent)->object;
 
   GTK_NOTE (BUILDER,
-            g_message ("adding %s to %s", object_get_name (object), object_get_name (parent)));
+            g_message ("adding %s to %s", object_get_id (object), object_get_id (parent)));
 
   if (G_IS_LIST_STORE (parent))
     {
@@ -1735,7 +1735,7 @@ gtk_builder_expose_object (GtkBuilder    *builder,
   g_return_if_fail (name && name[0]);
   g_return_if_fail (!g_hash_table_contains (priv->objects, name));
 
-  object_set_name (object, name);
+  object_set_id (object, name);
   g_hash_table_insert (priv->objects,
                        g_strdup (name),
                        g_object_ref (object));

diff --git a/gtk/gtkliststore.c b/gtk/gtkliststore.c
index f5b1347fbea7644290f6e6e0820660b52e91d70c..b1fa81e777470909af1414562f440cb2e5f1b6db 100644 (file)
--- a/gtk/gtkliststore.c
+++ b/gtk/gtkliststore.c
@@ -2511,7 +2511,7 @@ list_store_end_element (GtkBuildableParseContext  *context,
             {
               g_warning ("Unknown type %s specified in treemodel %s",
                          (const char *)l->data,
-                         gtk_buildable_get_name (GTK_BUILDABLE (data->object)));
+                         gtk_buildable_get_buildable_id (GTK_BUILDABLE (data->object)));
               continue;
             }
           column_types[i] = type;

diff --git a/gtk/gtktreestore.c b/gtk/gtktreestore.c
index aac3ae5ad3185662e4503c2f7bfb65f23e8e07e0..27cc237a49c7893e466e41e083fef43b2f56e8fe 100644 (file)
--- a/gtk/gtktreestore.c
+++ b/gtk/gtktreestore.c
@@ -3389,7 +3389,7 @@ tree_model_end_element (GtkBuildableParseContext  *context,
             {
               g_warning ("Unknown type %s specified in treemodel %s",
                          (const char *)l->data,
-                         gtk_buildable_get_name (GTK_BUILDABLE (data->object)));
+                         gtk_buildable_get_buildable_id (GTK_BUILDABLE (data->object)));
               continue;
             }
           types[i] = type;

diff --git a/gtk/gtkwidget.c b/gtk/gtkwidget.c
index f9d5f079f9dd254344572e34a4ae3b765d35d97c..2978107266f60774f617da7f418760b2ef96c124 100644 (file)
--- a/gtk/gtkwidget.c
+++ b/gtk/gtkwidget.c
@@ -604,9 +604,9 @@ static void             gtk_widget_real_state_flags_changed     (GtkWidget
 static void             gtk_widget_accessible_interface_init    (GtkAccessibleInterface *iface);
 
 static void             gtk_widget_buildable_interface_init     (GtkBuildableIface  *iface);
-static void             gtk_widget_buildable_set_name           (GtkBuildable       *buildable,
-                                                                 const char         *name);
-static const char *    gtk_widget_buildable_get_name           (GtkBuildable       *buildable);
+static void             gtk_widget_buildable_set_id             (GtkBuildable       *buildable,
+                                                                 const char         *id);
+static const char *    gtk_widget_buildable_get_id             (GtkBuildable       *buildable);
 static GObject *        gtk_widget_buildable_get_internal_child (GtkBuildable       *buildable,
                                                                  GtkBuilder         *builder,
                                                                  const char         *childname);
@@ -8113,7 +8113,7 @@ gtk_widget_accessible_interface_init (GtkAccessibleInterface *iface)
 /*
  * GtkBuildable implementation
  */
-static GQuark            quark_builder_set_name = 0;
+static GQuark            quark_builder_set_id = 0;
 
 static void
 gtk_widget_buildable_add_child (GtkBuildable  *buildable,
@@ -8143,10 +8143,10 @@ gtk_widget_buildable_add_child (GtkBuildable  *buildable,
 static void
 gtk_widget_buildable_interface_init (GtkBuildableIface *iface)
 {
-  quark_builder_set_name = g_quark_from_static_string ("gtk-builder-set-name");
+  quark_builder_set_id = g_quark_from_static_string ("gtk-builder-set-id");
 
-  iface->set_name = gtk_widget_buildable_set_name;
-  iface->get_name = gtk_widget_buildable_get_name;
+  iface->set_id = gtk_widget_buildable_set_id;
+  iface->get_id = gtk_widget_buildable_get_id;
   iface->get_internal_child = gtk_widget_buildable_get_internal_child;
   iface->parser_finished = gtk_widget_buildable_parser_finished;
   iface->custom_tag_start = gtk_widget_buildable_custom_tag_start;
@@ -8156,17 +8156,17 @@ gtk_widget_buildable_interface_init (GtkBuildableIface *iface)
 }
 
 static void
-gtk_widget_buildable_set_name (GtkBuildable *buildable,
-                              const char   *name)
+gtk_widget_buildable_set_id (GtkBuildable *buildable,
+                              const char   *id)
 {
-  g_object_set_qdata_full (G_OBJECT (buildable), quark_builder_set_name,
-                           g_strdup (name), g_free);
+  g_object_set_qdata_full (G_OBJECT (buildable), quark_builder_set_id,
+                           g_strdup (id), g_free);
 }
 
 static const char *
-gtk_widget_buildable_get_name (GtkBuildable *buildable)
+gtk_widget_buildable_get_id (GtkBuildable *buildable)
 {
-  return g_object_get_qdata (G_OBJECT (buildable), quark_builder_set_name);
+  return g_object_get_qdata (G_OBJECT (buildable), quark_builder_set_id);
 }
 
 static GObject *

diff --git a/gtk/inspector/misc-info.c b/gtk/inspector/misc-info.c
index d2bb6d950354812bae60dc17f173fc3b4ca71509..8d969d996f810bb9cf0612285673f81fdfe9f9f2 100644 (file)
--- a/gtk/inspector/misc-info.c
+++ b/gtk/inspector/misc-info.c
@@ -353,7 +353,7 @@ update_info (gpointer data)
   if (GTK_IS_BUILDABLE (sl->object))
     {
       gtk_label_set_text (GTK_LABEL (sl->buildable_id),
-                          gtk_buildable_get_name (GTK_BUILDABLE (sl->object)));
+                          gtk_buildable_get_buildable_id (GTK_BUILDABLE (sl->object)));
     }
 
   if (GDK_IS_FRAME_CLOCK (sl->object))

diff --git a/gtk/inspector/object-tree.c b/gtk/inspector/object-tree.c
index 664ad3074264026d10553b26dfc238e4b5fb219c..5f8c0363808ec14188e5886f2ffadd499b9a3b47 100644 (file)
--- a/gtk/inspector/object-tree.c
+++ b/gtk/inspector/object-tree.c
@@ -633,7 +633,7 @@ gtk_inspector_get_object_name (GObject *object)
     {
       const char *id;
 
-      id = gtk_buildable_get_name (GTK_BUILDABLE (object));
+      id = gtk_buildable_get_buildable_id (GTK_BUILDABLE (object));
       if (id != NULL && !g_str_has_prefix (id, "___object_"))
         return id;
     }

diff --git a/gtk/tools/gtk-builder-tool-enumerate.c b/gtk/tools/gtk-builder-tool-enumerate.c
index 382ad939292480814eab496e34cc62454d93c472..feb3758cc5ea5927c964d44c81d88b95bdc1f81f 100644 (file)
--- a/gtk/tools/gtk-builder-tool-enumerate.c
+++ b/gtk/tools/gtk-builder-tool-enumerate.c
@@ -29,12 +29,12 @@
 #include "gtk-builder-tool.h"
 
 static const char *
-object_get_name (GObject *object)
+object_get_id (GObject *object)
 {
   if (GTK_IS_BUILDABLE (object))
-    return gtk_buildable_get_name (GTK_BUILDABLE (object));
+    return gtk_buildable_get_buildable_id (GTK_BUILDABLE (object));
   else
-    return g_object_get_data (object, "gtk-builder-name");
+    return g_object_get_data (object, "gtk-builder-id");
 }
 
 void
@@ -63,7 +63,7 @@ do_enumerate (int *argc, const char ***argv)
   for (l = list; l; l = l->next)
     {
       object = l->data;
-      name = object_get_name (object);
+      name = object_get_id (object);
       if (g_str_has_prefix (name, "___") && g_str_has_suffix (name, "___"))
         continue;
 

diff --git a/gtk/tools/gtk-builder-tool-preview.c b/gtk/tools/gtk-builder-tool-preview.c
index 3dbc3d1b5b50e82706246994e76991761db3eb74..db345c7bca720b58a7fee08e8d167e377fed90ca 100644 (file)
--- a/gtk/tools/gtk-builder-tool-preview.c
+++ b/gtk/tools/gtk-builder-tool-preview.c
@@ -144,7 +144,7 @@ preview_file (const char *filename,
       window = gtk_window_new ();
 
       if (GTK_IS_BUILDABLE (object))
-        id = gtk_buildable_get_name (GTK_BUILDABLE (object));
+        id = gtk_buildable_get_buildable_id (GTK_BUILDABLE (object));
 
       set_window_title (GTK_WINDOW (window), filename, id);
 

diff --git a/testsuite/gtk/builder.c b/testsuite/gtk/builder.c
index 754d05c63eb2c2200757ad9f81e29d9922acecb9..78ff3c9b3ad2db0e84985d8f0063a64de411f73b 100644 (file)
--- a/testsuite/gtk/builder.c
+++ b/testsuite/gtk/builder.c
@@ -944,7 +944,7 @@ test_children (void)
   g_assert (button != NULL);
   g_assert (GTK_IS_BUTTON (button));
   g_assert (gtk_widget_get_parent (GTK_WIDGET(button)) != NULL);
-  g_assert (strcmp (gtk_buildable_get_name (GTK_BUILDABLE (gtk_widget_get_parent (GTK_WIDGET (button)))), "window1") == 0);
+  g_assert (strcmp (gtk_buildable_get_buildable_id (GTK_BUILDABLE (gtk_widget_get_parent (GTK_WIDGET (button)))), "window1") == 0);
 
   gtk_window_destroy (GTK_WINDOW (window));
   g_object_unref (builder);
@@ -965,14 +965,14 @@ test_children (void)
   g_assert (vbox != NULL);
   g_assert (GTK_IS_BOX (vbox));
   g_assert (gtk_orientable_get_orientation (GTK_ORIENTABLE (vbox)) == GTK_ORIENTATION_VERTICAL);
-  g_assert (strcmp (gtk_buildable_get_name (GTK_BUILDABLE (content_area)), "dialog1-vbox") == 0);
+  g_assert (strcmp (gtk_buildable_get_buildable_id (GTK_BUILDABLE (content_area)), "dialog1-vbox") == 0);
 
   action_area = gtk_builder_get_object (builder, "dialog1-action_area");
   g_assert (action_area != NULL);
   g_assert (GTK_IS_BOX (action_area));
   g_assert (gtk_orientable_get_orientation (GTK_ORIENTABLE (action_area)) == GTK_ORIENTATION_HORIZONTAL);
   g_assert (gtk_widget_get_parent (GTK_WIDGET (action_area)) != NULL);
-  g_assert (gtk_buildable_get_name (GTK_BUILDABLE (action_area)) != NULL);
+  g_assert (gtk_buildable_get_buildable_id (GTK_BUILDABLE (action_area)) != NULL);
   gtk_window_destroy (GTK_WINDOW (dialog));
   g_object_unref (builder);
 }